[workflows] add individual and batch instance deletion by vaishnav-mk · Pull Request #14735 · cloudflare/workers-sdk

vaishnav-mk · 2026-07-17T06:33:51Z

Adds individual and batch Workflow instance deletion to the runtime and SDK.

env.MY_WORKFLOW.get(id).delete() deletes one instance.
env.MY_WORKFLOW.deleteBatch(instanceIds) returns { deleted, errors } with per-instance results.
wrangler workflows instances delete <name> [id..] deletes one or up to 100 instances remotely or in local development; IDs can also come from a JSON array passed with --filename.
Missing batch targets are returned as errors; duplicate IDs are processed once.

Tests
- Tests included/updated
- Automated tests not possible - manual testing has been completed as follows:
- Additional testing not necessary because:
Public documentation
- Cloudflare docs PR(s): Workflows: document individual and batch instance deletion cloudflare-docs#32128
- Documentation not necessary because:

A picture of a cute animal (not mandatory, but encouraged)
(i want a cat like this :))

changeset-bot · 2026-07-17T06:33:55Z

🦋 Changeset detected

Latest commit: 94f1156

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 8 packages

Name	Type
wrangler	Minor
miniflare	Minor
@cloudflare/vite-plugin	Patch
@cloudflare/vitest-pool-workers	Patch
@cloudflare/deploy-helpers	Patch
@cloudflare/pages-shared	Patch
@cloudflare/remote-bindings	Patch
@cloudflare/runtime-types	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

github-actions · 2026-07-17T06:34:40Z

✅ All changesets look good

ask-bonk · 2026-07-17T06:36:00Z

I notice a real inconsistency worth flagging. The remote deleteInstance in utils.ts does NOT encodeURIComponent the workflowName or instanceId, while the local variant and other newer remote helpers do. Actually the remote ones (describe line 84, send-event line 79) also don't encode. So it's consistent with the existing remote convention. Not a new bug.

The implementation is consistent, well-tested, and follows established patterns for all sibling commands. The local DELETE route pre-exists in the explorer worker. The engine/binding changes mirror the terminate pattern correctly.

I've reviewed all changed files, the engine abort semantics, the binding pattern, the local-explorer route (pre-existing), CLI wiring, and tests. No actionable logic bugs, security issues, backward-compat violations, or incorrect API behavior found.

LGTM

github run

pkg-pr-new · 2026-07-17T06:37:21Z

@cloudflare/autoconfig

npm i https://pkg.pr.new/@cloudflare/autoconfig@14735

@cloudflare/build-output-utils

npm i https://pkg.pr.new/@cloudflare/build-output-utils@14735

@cloudflare/config

npm i https://pkg.pr.new/@cloudflare/config@14735

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@14735

@cloudflare/deploy-helpers

npm i https://pkg.pr.new/@cloudflare/deploy-helpers@14735

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@14735

miniflare

npm i https://pkg.pr.new/miniflare@14735

@cloudflare/pages-functions

npm i https://pkg.pr.new/@cloudflare/pages-functions@14735

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@14735

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@14735

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@14735

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@14735

@cloudflare/workers-auth

npm i https://pkg.pr.new/@cloudflare/workers-auth@14735

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@14735

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@14735

wrangler

npm i https://pkg.pr.new/wrangler@14735

commit: 94f1156

workers-devprod · 2026-07-24T08:03:58Z

Codeowners approval required for this PR:

@cloudflare/workflows
@cloudflare/wrangler

Show detailed file reviewers

.changeset/workflows-instances-delete.md: [@cloudflare/wrangler]
packages/miniflare/src/workers/workflows/wrapped-binding.worker.ts: [@cloudflare/wrangler]
packages/miniflare/test/plugins/workflows/index.spec.ts: [@cloudflare/wrangler]
packages/workflows-shared/src/binding.ts: [@cloudflare/workflows @cloudflare/wrangler]
packages/workflows-shared/src/engine.ts: [@cloudflare/workflows @cloudflare/wrangler]
packages/workflows-shared/src/lib/errors.ts: [@cloudflare/workflows @cloudflare/wrangler]
packages/workflows-shared/src/types.ts: [@cloudflare/workflows @cloudflare/wrangler]
packages/workflows-shared/tests/binding.test.ts: [@cloudflare/workflows @cloudflare/wrangler]
packages/wrangler/src/tests/workflows.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/index.ts: [@cloudflare/wrangler]
packages/wrangler/src/workflows/commands/instances/delete.ts: [@cloudflare/wrangler]
packages/wrangler/src/workflows/local.ts: [@cloudflare/wrangler]
packages/wrangler/src/workflows/utils.ts: [@cloudflare/wrangler]

devin-ai-integration

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

workers-devprod · 2026-08-04T09:08:42Z

Codeowners approval required for this PR:

@cloudflare/workflows
@cloudflare/wrangler

Show detailed file reviewers

.changeset/workflows-instances-delete.md: [@cloudflare/wrangler]
packages/miniflare/scripts/openapi-filter-config.ts: [@cloudflare/wrangler]
packages/miniflare/src/index.ts: [@cloudflare/wrangler]
packages/miniflare/src/plugins/workflows/index.ts: [@cloudflare/wrangler]
packages/miniflare/src/workers/local-explorer/explorer.worker.ts: [@cloudflare/wrangler]
packages/miniflare/src/workers/local-explorer/generated/index.ts: [@cloudflare/wrangler]
packages/miniflare/src/workers/local-explorer/generated/types.gen.ts: [@cloudflare/wrangler]
packages/miniflare/src/workers/local-explorer/generated/zod.gen.ts: [@cloudflare/wrangler]
packages/miniflare/src/workers/local-explorer/openapi.local.json: [@cloudflare/wrangler]
packages/miniflare/src/workers/local-explorer/resources/workflows.ts: [@cloudflare/wrangler]
packages/miniflare/src/workers/local-explorer/route-names.ts: [@cloudflare/wrangler]
packages/miniflare/src/workers/workflows/wrapped-binding.worker.ts: [@cloudflare/wrangler]
packages/miniflare/test/plugins/workflows/index.spec.ts: [@cloudflare/wrangler]
packages/miniflare/test/plugins/workflows/wrapped-binding.spec.ts: [@cloudflare/wrangler]
packages/miniflare/vitest.config.mts: [@cloudflare/wrangler]
packages/workflows-shared/src/binding.ts: [@cloudflare/workflows @cloudflare/wrangler]
packages/workflows-shared/src/engine.ts: [@cloudflare/workflows @cloudflare/wrangler]
packages/workflows-shared/src/lib/errors.ts: [@cloudflare/workflows @cloudflare/wrangler]
packages/workflows-shared/src/types.ts: [@cloudflare/workflows @cloudflare/wrangler]
packages/workflows-shared/tests/binding.test.ts: [@cloudflare/workflows @cloudflare/wrangler]
packages/wrangler/src/tests/workflows.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/index.ts: [@cloudflare/wrangler]
packages/wrangler/src/workflows/commands/instances/delete.ts: [@cloudflare/wrangler]
packages/wrangler/src/workflows/local.ts: [@cloudflare/wrangler]
packages/wrangler/src/workflows/utils.ts: [@cloudflare/wrangler]

devin-ai-integration

Devin Review found 1 new potential issue.

View 5 additional findings in Devin Review.

workers-devprod added this to workers-sdk Jul 17, 2026

github-project-automation Bot moved this to Untriaged in workers-sdk Jul 17, 2026

vaishnav-mk changed the title ~~[workflows]: add instance delete support~~ [workflows] add batch instance deletion Jul 19, 2026

vaishnav-mk force-pushed the vaish/workflows-instance-delete branch from 69f16be to d8999b6 Compare July 23, 2026 09:28

vaishnav-mk changed the title ~~[workflows] add batch instance deletion~~ [workflows] add individual and batch instance deletion Jul 23, 2026

vaishnav-mk force-pushed the vaish/workflows-instance-delete branch 4 times, most recently from ca9e0b4 to 4053e13 Compare July 23, 2026 10:03

vaishnav-mk marked this pull request as ready for review July 24, 2026 08:03

vaishnav-mk requested a review from workers-devprod as a code owner July 24, 2026 08:03

workers-devprod requested review from a team and emily-shen and removed request for a team July 24, 2026 08:03

devin-ai-integration Bot reviewed Jul 24, 2026

View reviewed changes

vaishnav-mk force-pushed the vaish/workflows-instance-delete branch 2 times, most recently from 39ff819 to 8e20310 Compare July 24, 2026 08:21

pombosilva reviewed Jul 24, 2026

View reviewed changes

Comment thread packages/wrangler/src/workflows/commands/instances/delete.ts

vaishnav-mk force-pushed the vaish/workflows-instance-delete branch 3 times, most recently from 0825bc4 to 3086aae Compare July 27, 2026 11:54

vaishnav-mk requested a review from pombosilva July 27, 2026 11:57

emily-shen reviewed Jul 28, 2026

View reviewed changes

vaishnav-mk force-pushed the vaish/workflows-instance-delete branch from 3086aae to 832e762 Compare July 29, 2026 15:04